home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / sesmgr.z / sesmgr
Encoding:
Text File  |  2001-04-17  |  18.3 KB  |  397 lines
  1.  
  2.  
  3.  
  4. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      sssseeeessssmmmmggggrrrr - Fibre Channel Drive Enclosure Status/Configuration Command Line
  10.      Interface
  11.  
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      The command line syntax of sssseeeessssmmmmggggrrrr takes multiple flavors depending on the
  15.      option.
  16.  
  17.      sssseeeessssmmmmggggrrrr ggggeeeettttvvvveeeerrrrssssiiiioooonnnn
  18.      sssseeeessssmmmmggggrrrr ppppoooollllllll
  19.      sssseeeessssmmmmggggrrrr ttttooooppppoooollllooooggggyyyy [----cccc _c_h_a_n_n_e_l-_I_D [----cccc _c_h_a_n_n_e_l-_I_D] . . .
  20.      sssseeeessssmmmmggggrrrr ggggeeeettttssssttttaaaattttuuuussss [----vvvv] [----cccc _c_h_a_n_n_e_l-_I_D] [----eeee _e_n_c_l_o_s_u_r_e-_I_D] . .
  21.      sssseeeessssmmmmggggrrrr rrrreeeemmmmoooovvvveeee ----tttt _t_a_r_g_e_t-_I_D [----tttt _t_a_r_g_e_t-_I_D] . . .
  22.      sssseeeessssmmmmggggrrrr lllleeeeddddoooonnnn ----tttt _t_a_r_g_e_t-_I_D [----tttt _t_a_r_g_e_t-_I_D] . . .
  23.      sssseeeessssmmmmggggrrrr lllleeeeddddooooffffffff ----tttt _t_a_r_g_e_t-_I_D [----tttt _t_a_r_g_e_t-_I_D] . . .
  24.      sssseeeessssmmmmggggrrrr bbbbyyyyppppaaaassssssss ----tttt _t_a_r_g_e_t-_I_D ----pppp _A|_B [----tttt _t_a_r_g_e_t-_I_D ----pppp _A|_B] . . .
  25.      sssseeeessssmmmmggggrrrr uuuunnnnbbbbyyyyppppaaaassssssss ----tttt _t_a_r_g_e_t-_I_D ----pppp _A|_B [----tttt _t_a_r_g_e_t-_I_D ----pppp _A|_B] . . .
  26.      sssseeeessssmmmmggggrrrr iiiinnnnsssseeeerrrrtttt ----eeee _e_n_c_l_o_s_u_r_e-_I_D [----eeee _e_n_c_l_o_s_u_r_e-_I_D] . . .
  27.      sssseeeessssmmmmggggrrrr aaaallllaaaarrrrmmmmoooonnnn ----eeee _e_n_c_l_o_s_u_r_e-_I_D [----eeee _e_n_c_l_o_s_u_r_e-_I_D] . . .
  28.      sssseeeessssmmmmggggrrrr aaaallllaaaarrrrmmmmmmmmuuuutttteeee ----eeee _e_n_c_l_o_s_u_r_e-_I_D [----eeee _e_n_c_l_o_s_u_r_e-_I_D] . . .
  29.      sssseeeessssmmmmggggrrrr aaaallllaaaarrrrmmmmooooffffffff ----eeee _e_n_c_l_o_s_u_r_e-_I_D [----eeee _e_n_c_l_o_s_u_r_e-_I_D] . . .
  30.  
  31.  
  32.  
  33. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.      The sesmgr command is a user front end to sssseeeessssddddaaaaeeeemmmmoooonnnn which collects status
  35.      of all supported fibre channel enclosures and allows for configuration
  36.      changes.
  37.  
  38.  
  39. CCCCOOOOMMMMMMMMAAAANNNNDDDDSSSS
  40.      ggggeeeettttvvvveeeerrrrssssiiiioooonnnn     This command will report the version level of sssseeeessssmmmmggggrrrr.
  41.  
  42.      ppppoooollllllll           This command will request that the daemon re-scan the SAN
  43.                     for its configuration and also update the status of all
  44.                     known devices.  Typically this should only need to be done
  45.                     if the SAN configuration is manually changed outside of
  46.                     the sesmgr command set.
  47.  
  48.      ttttooooppppoooollllooooggggyyyy       This command will print the daemon's understanding of the
  49.                     topology of the SAN.  It will print all of the drive
  50.                     target's worldwide names, port id's, port numbers, and if
  51.                     the controller is in loop mode, the name the device is
  52.                     known by.  A list of all known drive targets which
  53.                     sssseeeessssddddaaaaeeeemmmmoooonnnn is not able to manage is also printed.  This
  54.                     list would include RAIDS (as its not easily possible to
  55.                     distinguish them from JBODS), targets in unsupported
  56.                     enclosures, and targets in enclosures which do not have
  57.                     working devices in the SES capable slots for the ports
  58.                     reachable by the host running sssseeeessssddddaaaaeeeemmmmoooonnnn.  Targets which
  59.                     are not disk drives are ignored by sssseeeessssddddaaaaeeeemmmmoooonnnn.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  71.  
  72.  
  73.  
  74.      ggggeeeettttssssttttaaaattttuuuussss      This command reports status of supported fibre channel
  75.                     drive enclosures.
  76.  
  77.                     For this option, -v (verbose) alone will print a detailed
  78.                     status of all enclosures, -v with specified channel
  79.                     numbers will print a detailed status for the enclosures on
  80.                     the listed channels.  If enclosure arguments are specified
  81.                     then a detailed status will be printed for only those
  82.                     enclosures (and the -v flag is unnecessary).
  83.  
  84.                     If the -v flag is not used, and no arguments are
  85.                     specified, then overall summaries of all fibre channel
  86.                     controllers will be printed. Or only for the specified
  87.                     channels if channel arguments are used.
  88.  
  89.      rrrreeeemmmmoooovvvveeee         This command will allow for physical removal of a drive.
  90.                     I.E. it will spin-down the specified disk drive, and
  91.                     prompt the user for removal, then after all the removes
  92.                     have taken place it will SOP_SCAN the effected
  93.                     controllers.
  94.  
  95.                     Note:  This command issues the spindown command to the
  96.                     drive immediately which locks the drive heads.  However,
  97.                     the drive requires additional time to stop rotating and
  98.                     will still be turning when the exchange prompt is issued.
  99.  
  100.      iiiinnnnsssseeeerrrrtttt         This command will allow for inserting a drive into a
  101.                     specified enclosure. I.E. it will prompt for insertion,
  102.                     and after all the inserts have taken place, it will spin
  103.                     it up the drives, SOP_SCAN the effected controllers, and
  104.                     call iiiiooooccccoooonnnnffffiiiigggg to update the hardware graph.
  105.  
  106.      lllleeeeddddoooonnnn          This command will turn "ON" the indicator "LED" associated
  107.                     with the specified disk device.
  108.  
  109.      lllleeeeddddooooffffffff         This command will turn "OFF" the indicator "LED"
  110.                     associated with the specified disk device.
  111.  
  112.      bbbbyyyyppppaaaassssssss         This command will perform an enclosure bypass to remove
  113.                     the specified disk on the specified port from the fibre
  114.                     channel loop.
  115.  
  116.      uuuunnnnbbbbyyyyppppaaaassssssss       This command will perform an enclosure unbypass to add the
  117.                     specified disk on the specified port onto the fibre
  118.                     channel loop.
  119.  
  120.      aaaallllaaaarrrrmmmmoooonnnn        This command will sound the alarm on the specified
  121.                     enclosure.
  122.  
  123.      aaaallllaaaarrrrmmmmooooffffffff       This command will turn off the alarm on the specified
  124.                     enclosure provided that the enclosure is clear of any
  125.                     other hardware conditions which also result in the alarm
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  137.  
  138.  
  139.  
  140.                     sounding.
  141.  
  142.      aaaallllaaaarrrrmmmmmmmmuuuutttteeee      This command will mute the enclosure's alarm.  Generally
  143.                     this will result in a periodic reminder tone instead of
  144.                     totally silencing it.
  145.  
  146.  
  147. CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
  148.      ----cccc _c_h_a_n_n_e_l-_I_D  Use this option to limit a status command to a particular
  149.                     fibre channel controller.
  150.  
  151.      ----eeee _e_n_c_l_o_s_u_r_e-_I_D
  152.                     Use this option to specify a particular enclosure.
  153.                     Enclosures are identified by a 64 bit hex number similar
  154.                     to a world wide name. (Don't forget the 0x prefix on the
  155.                     arguments for this option.)
  156.  
  157.      ----tttt _t_a_r_g_e_t-_I_D   Use this option to direct an action at a particular drive
  158.                     or set of drives.  Targets are identified by their world
  159.                     wide name, a 64 bit hex number unique to each drive.
  160.                     (Don't forget the 0x prefix.)  If the target is operating
  161.                     on a private loop, it is also possible to specify it by
  162.                     its sc* name in /hw/scsi (eg sc4d65l0).
  163.  
  164.  
  165. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  166.      Obtaining the revision level of the instance of sssseeeessssmmmmggggrrrr running locally
  167.  
  168.           sssseeeessssmmmmggggrrrr ggggeeeettttvvvveeeerrrrssssiiiioooonnnn
  169.  
  170.           sample output:
  171.  
  172.           sesdaemon version 1.0, Thu May 11 18:46:09 PDT 2000
  173.  
  174.  
  175.  
  176.      Obtaining a brief channel status summary:
  177.  
  178.           sssseeeessssmmmmggggrrrr ggggeeeettttssssttttaaaattttuuuussss
  179.  
  180.           sample output:
  181.  
  182.           CHANNEL | DRIVES    POWER    LCC     FANS     TEMP    ALARM
  183.           --------+--------------------------------------------------
  184.               2   |  NONE     NONE     NONE     NONE     NONE    NONE
  185.               3   |   OK      FAIL      OK       OK       OK      ON
  186.               4   |   OK       OK       OK       OK       OK     NONE
  187.  
  188.      The example shows that channel 3 has one or more enclosures reporting a
  189.      power supply fault and an alarm is sounding. Channel 2 shows "NONE" which
  190.      indicates a few possibilities.
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  203.  
  204.  
  205.  
  206.      o  There are no recognized fibre channel enclosures connect to the
  207.         channel.
  208.      o  There is a communication problem on the channel.
  209.      o  "NONE" can also mean that none of the recognized enclosures support
  210.         that feature.  As on channel 4, the enclosures do not include an
  211.         alarm.
  212.  
  213.      Obtaining a detailed status of an enclosure:
  214.  
  215.           sssseeeessssmmmmggggrrrr ggggeeeettttssssttttaaaattttuuuussss ----eeee 0000xxxx55550000000055550000cccccccc00000000000000000000222200005555cccc
  216.  
  217.           sample output:
  218.      Enclosure ID:  0x50050cc00000205c
  219.        Vendor ID: XYRATEX
  220.        Product ID: SS-1202-FCAL
  221.        FRU's (Inst/Max):  11 of 12 drives
  222.                           2 of 3 power supplies
  223.                           1 of 2 recognized lcc's
  224.        Last successful status poll: Tue May 16 17:19:17 2000
  225.  
  226.  
  227.        +---------------------------+    Slot    Worldwide Name (*=SES)
  228.        | 1/1  | 2/1  | 3/1  | 4/1  |    1/1     0x20000020374bab85
  229.        |  OK  |  OK  |  OK  |  OK  |    2/1     0x20000020374bb5e2
  230.        |      |      |      |      |    3/1     0x20000020374bb504
  231.        +---------------------------+    4/1     0x20000020374b17ee
  232.        | 1/2  | 2/2  | 3/2  | 4/2  |    1/2     0x20000020374baf03
  233.        |  OK  | OUT  |  OK  |  OK  |    2/2     0x0
  234.        |      |      |      |      |    3/2     0x20000020374bafdc
  235.        +---------------------------+    4/2     0x20000020374b194f
  236.        | 1/3  | 2/3  | 3/3  | 4/3  |    1/3     0x20000020374bb280*
  237.        |  OK  |  OK  |  OK  |  OK  |    2/3     0x20000020374bb007
  238.        |      |      |      |      |    3/3     0x20000020374bafe1
  239.        +---------------------------+    4/3     0x20000020374bb271*
  240.        FAN0  OK     FAN1  OK     FAN2 OUT
  241.        PS0   OK     PS1   OK     PS2  OUT
  242.        TEMP  OK      29 C        ALARM  OK
  243.  
  244.      The example shows that slot 2/2 does not have a drive in it, and both fan
  245.      2 and power supply 2 are not installed.  Also this enclosure either has
  246.      only one fibre channel loop connection or else only one is visible
  247.      (connected) to the host.
  248.  
  249.      Illuminating the LEDs associated with disk 1/1 and 2/1:
  250.  
  251.           sssseeeessssmmmmggggrrrr lllleeeeddddoooonnnn ----tttt 0000xxxx22220000000000000000000022220000333377774444bbbbaaaabbbb88885555 ----tttt 0000xxxx22220000000000000000000022220000333377774444bbbbbbbb5555eeee2222
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  269.  
  270.  
  271.  
  272. LIMITATIONS
  273.      Commands which change the enclosure status will not be reflected by
  274.      ggggeeeettttssssttttaaaattttuuuussss until the next status poll executes (or until a ppppoooollllllll command is
  275.      run).
  276.  
  277.      Currently the only supported enclosures are the Xyratex 12 slot and
  278.      Clariion 10 slot enclosures.
  279.  
  280.      Not all enclosures will support all commands or types of FRU's.  For
  281.      example, the Xyratex 12 slot enclosure does not support enclosure bypass
  282.      and unbypass.  And the Clariion enclosure does not have an alarm.
  283.  
  284.      The lllleeeeddddoooonnnn and lllleeeeddddooooffffffff commands may indicate differently depending on the
  285.      enclosure's implementation.  For example, the Xyratex 12 will slowly
  286.      blink the activity led when its "on", and leave it lit solidly when
  287.      "off".  Clariion enclosures will solidly indicate on the fault LED.
  288.  
  289.      Removing a drive can send a controller into error recovery mode as it
  290.      tries to find the target and bring it back online.
  291.  
  292.      It may take a while for SOP_SCAN and iiiiooooccccoooonnnnffffiiiigggg to complete depending on
  293.      how large and how busy the SAN is.
  294.  
  295.      When a device is specified by its sc* loop name, the code will find that
  296.      device.  However commands to that device may use alternate paths.
  297.  
  298.      On ppppoooollllllll updates its possible that failed equipment may disappear and no
  299.      longer be shown as failed.  Failed targets can be dropped from the target
  300.      list, but they should still be printed in their enclosure slot by
  301.      ggggeeeettttssssttttaaaattttuuuussss.  Enclosures which are no longer reachable (and their targets)
  302.      may be dropped entirely.  This is due to a configuration update
  303.      assumption that targets which do not respond were intentionally moved.
  304.  
  305.      bbbbyyyyppppaaaassssssss and uuuunnnnbbbbyyyyppppaaaassssssss can fail if the commands can not be issued on the
  306.      same loop that the specified device's port is on.
  307.  
  308.      If a drive is bypassed so that the system no longer sees an active
  309.      target, and the daemon is restarted, the target may no longer be seen.
  310.      In this situation it will not be possible to issue an unbypass command to
  311.      the target.
  312.  
  313.      In order to run sssseeeessssmmmmggggrrrr under TRIX, the user must have a MAC label of
  314.      dblow and a capability of CAP_PRIV_PORT.
  315.  
  316.  
  317. DDDDIIIIFFFFFFFFEEEERRRREEEENNNNCCCCEEEESSSS FFFFRRRROOOOMMMM FFFFCCCCCCCCLLLLIIII
  318.      Although the sssseeeessssddddaaaaeeeemmmmoooonnnn/sssseeeessssmmmmggggrrrr utilities are designed to be similar in
  319.      look and functionality, there are some important differences.  Here are
  320.      some of these:
  321.  
  322.      Enclosure ID's and target ID's are now 64 bit hex integers.
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. sssseeeessssmmmmggggrrrr((((1111mmmm))))                                                          sssseeeessssmmmmggggrrrr((((1111mmmm))))
  335.  
  336.  
  337.  
  338.      iiiinnnnsssseeeerrrrtttt now takes an enclosure ID, not a target ID.
  339.  
  340.      An argument id is now required before each one (eg -t) to tell what type
  341.      it is.
  342.  
  343.      Target lists are no longer restricted to an individual controller.
  344.  
  345.      bbbbyyyyppppaaaassssssss and uuuunnnnbbbbyyyyppppaaaassssssss are enclosure commands only.  Loop commands are not
  346.      attempted.
  347.  
  348.  
  349. FFFFIIIILLLLEEEESSSS
  350.      /usr/sbin/sesmgr
  351.  
  352.  
  353. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  354.      ioconfig(1M), scsiha(7), sesdaemon(1M)
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                                                         PPPPaaaaggggeeee 6666
  394.  
  395.  
  396.  
  397.